<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>estimate_al_am [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_3dreconstruction.html">3D Reconstruction</a> / <a href="toc_3dreconstruction_photometricstereo.html">Photometric Stereo</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">estimate_al_am</span><span data-if="c" style="display:none;">estimate_al_am</span><span data-if="cpp" style="display:none;">EstimateAlAm</span><span data-if="dotnet" style="display:none;">EstimateAlAm</span><span data-if="python" style="display:none;">estimate_al_am</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">estimate_al_am</span><span data-if="c" style="display:none;">estimate_al_am</span><span data-if="cpp" style="display:none;">EstimateAlAm</span><span data-if="dotnet" style="display:none;">EstimateAlAm</span><span data-if="python" style="display:none;">estimate_al_am</span></code> — Estimate the albedo of a surface and the amount of ambient light.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>estimate_al_am</b>(<a href="#Image"><i>Image</i></a> :  :  : <a href="#Albedo"><i>Albedo</i></a>, <a href="#Ambient"><i>Ambient</i></a>)</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>estimate_al_am</b>(const Hobject <a href="#Image"><i>Image</i></a>, double* <a href="#Albedo"><i>Albedo</i></a>, double* <a href="#Ambient"><i>Ambient</i></a>)</code></p>
<p>
<code>Herror <b>T_estimate_al_am</b>(const Hobject <a href="#Image"><i>Image</i></a>, Htuple* <a href="#Albedo"><i>Albedo</i></a>, Htuple* <a href="#Ambient"><i>Ambient</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>EstimateAlAm</b>(const HObject&amp; <a href="#Image"><i>Image</i></a>, HTuple* <a href="#Albedo"><i>Albedo</i></a>, HTuple* <a href="#Ambient"><i>Ambient</i></a>)</code></p>
<p>
<code><a href="HTuple.html">HTuple</a> <a href="HImage.html">HImage</a>::<b>EstimateAlAm</b>(HTuple* <a href="#Ambient"><i>Ambient</i></a>) const</code></p>
<p>
<code>double <a href="HImage.html">HImage</a>::<b>EstimateAlAm</b>(double* <a href="#Ambient"><i>Ambient</i></a>) const</code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>EstimateAlAm</b>(<a href="HObject.html">HObject</a> <a href="#Image"><i>image</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#Albedo"><i>albedo</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#Ambient"><i>ambient</i></a>)</code></p>
<p>
<code><a href="HTuple.html">HTuple</a> <a href="HImage.html">HImage</a>.<b>EstimateAlAm</b>(out <a href="HTuple.html">HTuple</a> <a href="#Ambient"><i>ambient</i></a>)</code></p>
<p>
<code>double <a href="HImage.html">HImage</a>.<b>EstimateAlAm</b>(out double <a href="#Ambient"><i>ambient</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>estimate_al_am</b>(<a href="#Image"><i>image</i></a>: HObject) -&gt; Tuple[Sequence[float], Sequence[float]]</code></p>
<p>
<code>def <b>estimate_al_am_s</b>(<a href="#Image"><i>image</i></a>: HObject) -&gt; Tuple[float, float]</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p><code><span data-if="hdevelop" style="display:inline">estimate_al_am</span><span data-if="c" style="display:none">estimate_al_am</span><span data-if="cpp" style="display:none">EstimateAlAm</span><span data-if="com" style="display:none">EstimateAlAm</span><span data-if="dotnet" style="display:none">EstimateAlAm</span><span data-if="python" style="display:none">estimate_al_am</span></code> estimates the <a href="#Albedo"><i><code><span data-if="hdevelop" style="display:inline">Albedo</span><span data-if="c" style="display:none">Albedo</span><span data-if="cpp" style="display:none">Albedo</span><span data-if="com" style="display:none">Albedo</span><span data-if="dotnet" style="display:none">albedo</span><span data-if="python" style="display:none">albedo</span></code></i></a> of a
surface, i.e. the percentage of light reflected by the surface, and
the amount of ambient light <a href="#Ambient"><i><code><span data-if="hdevelop" style="display:inline">Ambient</span><span data-if="c" style="display:none">Ambient</span><span data-if="cpp" style="display:none">Ambient</span><span data-if="com" style="display:none">Ambient</span><span data-if="dotnet" style="display:none">ambient</span><span data-if="python" style="display:none">ambient</span></code></i></a> by using the maximum
and minimum gray values of the image.</p>
<h2 id="sec_attention">注意</h2>
<p>It is assumed that the image contains at least one point for which
the reflection function assumes its minimum, e.g., points in
shadows.  Furthermore, it is assumed that the image contains at
least one point for which the reflection function assumes its
maximum.  If this is not the case, wrong values will be
estimated.</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  
    <li>在元组级别自动并行化。</li>
  
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Image" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></b> (input_object)  </span><span>singlechannelimage(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject</span> (byte)</span>
</div>
<p class="pardesc">Image for which albedo and ambient are to be estimated.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Albedo" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Albedo</span><span data-if="c" style="display:none">Albedo</span><span data-if="cpp" style="display:none">Albedo</span><span data-if="com" style="display:none">Albedo</span><span data-if="dotnet" style="display:none">albedo</span><span data-if="python" style="display:none">albedo</span></code></b> (output_control)  </span><span>real(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[float]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real)</span><span data-if="dotnet" style="display:none"> (<i>double</i>)</span><span data-if="cpp" style="display:none"> (<i>double</i>)</span><span data-if="c" style="display:none"> (<i>double</i>)</span></span>
</div>
<p class="pardesc">Amount of light reflected by the surface.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Ambient" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Ambient</span><span data-if="c" style="display:none">Ambient</span><span data-if="cpp" style="display:none">Ambient</span><span data-if="com" style="display:none">Ambient</span><span data-if="dotnet" style="display:none">ambient</span><span data-if="python" style="display:none">ambient</span></code></b> (output_control)  </span><span>real(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[float]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real)</span><span data-if="dotnet" style="display:none"> (<i>double</i>)</span><span data-if="cpp" style="display:none"> (<i>double</i>)</span><span data-if="c" style="display:none"> (<i>double</i>)</span></span>
</div>
<p class="pardesc">Amount of ambient light.</p>
</div>
<h2 id="sec_result">结果</h2>
<p><code><span data-if="hdevelop" style="display:inline">estimate_al_am</span><span data-if="c" style="display:none">estimate_al_am</span><span data-if="cpp" style="display:none">EstimateAlAm</span><span data-if="com" style="display:none">EstimateAlAm</span><span data-if="dotnet" style="display:none">EstimateAlAm</span><span data-if="python" style="display:none">estimate_al_am</span></code> always 返回值 <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
    .</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="sfs_mod_lr.html"><span data-if="hdevelop" style="display:inline">sfs_mod_lr</span><span data-if="c" style="display:none">sfs_mod_lr</span><span data-if="cpp" style="display:none">SfsModLr</span><span data-if="com" style="display:none">SfsModLr</span><span data-if="dotnet" style="display:none">SfsModLr</span><span data-if="python" style="display:none">sfs_mod_lr</span></a></code>, 
<code><a href="sfs_orig_lr.html"><span data-if="hdevelop" style="display:inline">sfs_orig_lr</span><span data-if="c" style="display:none">sfs_orig_lr</span><span data-if="cpp" style="display:none">SfsOrigLr</span><span data-if="com" style="display:none">SfsOrigLr</span><span data-if="dotnet" style="display:none">SfsOrigLr</span><span data-if="python" style="display:none">sfs_orig_lr</span></a></code>, 
<code><a href="sfs_pentland.html"><span data-if="hdevelop" style="display:inline">sfs_pentland</span><span data-if="c" style="display:none">sfs_pentland</span><span data-if="cpp" style="display:none">SfsPentland</span><span data-if="com" style="display:none">SfsPentland</span><span data-if="dotnet" style="display:none">SfsPentland</span><span data-if="python" style="display:none">sfs_pentland</span></a></code>, 
<code><a href="photometric_stereo.html"><span data-if="hdevelop" style="display:inline">photometric_stereo</span><span data-if="c" style="display:none">photometric_stereo</span><span data-if="cpp" style="display:none">PhotometricStereo</span><span data-if="com" style="display:none">PhotometricStereo</span><span data-if="dotnet" style="display:none">PhotometricStereo</span><span data-if="python" style="display:none">photometric_stereo</span></a></code>, 
<code><a href="shade_height_field.html"><span data-if="hdevelop" style="display:inline">shade_height_field</span><span data-if="c" style="display:none">shade_height_field</span><span data-if="cpp" style="display:none">ShadeHeightField</span><span data-if="com" style="display:none">ShadeHeightField</span><span data-if="dotnet" style="display:none">ShadeHeightField</span><span data-if="python" style="display:none">shade_height_field</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
3D Metrology</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
